home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / com_net / mail / amiqwk / amiqwk.doc < prev    next >
Text File  |  2000-01-01  |  56KB  |  1,617 lines
  1.  
  2.  
  3. Introduction
  4. ************
  5.  
  6. About this manual
  7. =================
  8.  
  9.    This manual assumes that you have at least a basic knowledge of the
  10. Amiga operating system. If you are not familiar with the Amiga I,
  11. recommend reading the 'Basic Operations' chapter of your AmigaDOS
  12. manual.
  13.  
  14.    This manual was written in `Texinfo', the GNU documentation format,
  15. and processed through `MakeGuide' to generate ASCII, `AmigaGuide', and
  16. TeX versions.
  17.  
  18. What is QWKMail?
  19. ================
  20.  
  21.    QWKMail is an offline message format. Using QWKMail allows you to
  22. call a BBS, collect all waiting messages, transfer them to your
  23. computer, and read them after you have logged off of the BBS. You can
  24. then read them with a QWK compatible message reader such as `AmiQWK'.
  25. New messages can be edited with your favorite text editor. Some of the
  26. advantages of using QWKMail include:
  27.  
  28.    * Collecting all waiting messages into a QWKMail packet usually
  29.      takes only a fraction of the time it takes to read messages
  30.      online, resulting in lower phone bills.
  31.  
  32.    * Since your replies are edited offline, you can take as much time
  33.      as you need to enter and reply to messages. You also have the
  34.      advantage of using tools that may not be available when using BBS
  35.      editors, such as spelling and grammar checkers.
  36.  
  37.    * You can easily save or print messages for future reference.
  38.  
  39.    The QWK format was created in 1987 by Mark 'Sparky' Herring. It is
  40. based on Clark Development Corp.'s `PC-Board' Version 12.0 BBS message
  41. base format.  The QWKMail format is now supported by most BBS programs
  42. either internally or by an external 'door' program.
  43.  
  44. What is AmiQWK II?
  45. ==================
  46.  
  47.    `AmiQWK II' is a full featured QWKMail offline message reader for the
  48. Commodore Amiga computer. My goals for `AmiQWK' are (in no particular
  49. order)
  50.  
  51.    * To be the most stable and compatible QWKMail reader available for
  52.      the Commodore Amiga computer.
  53.  
  54.    * To be the most full featured QWKMail reader for the Commodore Amiga
  55.      computer.
  56.  
  57.    * To take advantage of features found Release 2 and higher of the
  58.      Amiga operating system.
  59.  
  60.    * To be easy to use.
  61.  
  62.    * To be highly configurable.
  63.  
  64. Legal Stuff
  65. ***********
  66.  
  67. About Shareware
  68. ===============
  69.  
  70.    `AmiQWK II' is released under the concept of Shareware. This means
  71. that you are granted a license to use `AmiQWK II' for a period of 30
  72. days after the initial use. After 30 days you must either register the
  73. program or discontinue its use. See Registration, for more details.
  74.  
  75. Registration
  76. ============
  77.  
  78.    To register `AmiQWK', fill out the registration form (filename
  79. `Registration.form') and send it along with your payment to the address
  80. on the registration form. You will receive a 16 digit registration key
  81. based on your name. Enter this number into the 'Register' window of the
  82. configuration editor and `AmiQWK II' will generate a keyfile
  83. (`AmiQWK.KEY') that will remove the shareware registration notices.
  84.  
  85.    Recommended method of payment is a check drwan from a U.S. bank or a
  86. money order in US dollars. (I cannot accept personal checks drawn from
  87. Canadian banks due to costs of processing.) Cash is accepted (US Funds
  88. only), however you send cash at your own risk.
  89.  
  90.    AmiQWK users in New Zealand, Australia, and Europe can register
  91. through my overseas distributors. See the registration form (filename
  92. `registration.form') for more details.
  93.  
  94.    The registration key will work with all minor revisions of `AmiQWK
  95. II'.  (i.e. all versions up to, but not including, version 3.0) When a
  96. new major revision becomes available, registered `AmiQWK II' users will
  97. be eligible for reduced cost updates.
  98.  
  99.    Most registrations are processed within 2 working days. If a network
  100. address is given, I will send your registration key via email in
  101. addition to postal mail. I can also send the registration key via FAX
  102. in the U.S.  and Canada.
  103.  
  104.    Group registrations (for Users Groups, BBSes, etc.) and site
  105. licenses are available. Current pricing is $12.50 each for 5-9
  106. registration keys, and $10.00 each for 10 or more registration keys
  107. when purchased at the same time. After the initial order, individual
  108. orders may be placed at the group price. Contact the author for
  109. details. See Technical Support.
  110.  
  111. Warranty
  112. ========
  113.  
  114.    THIS PRODUCT IS PROVIDED "AS-IS" WITHOUT WARRANTY OF ANY KIND. ALL
  115. RISKS AND DAMAGES, INCIDENTAL OR OTHERWISE, ARISING FROM THE USE,
  116. MISUSE, OR INABILITY TO USE THIS PROGRAM ARE ENTIRELY THE
  117. RESPONSIBILITY OF THE USER.  THE AUTHOR DOES NOT MAKE ANY GUARANTEES OR
  118. REPRESENTATIONS REGARDING THE CORRECTNESS, RELIABILITY, ACCURACY,
  119. CURRENTNESS, ETC. OF THIS PROGRAM. THE AUTHOR WILL NOT ACCEPT
  120. RESPONSIBILITY FOR ANY DAMAGE OR LOSSES RESULTING FORM THE USE, MISUSE,
  121. OR INABILITY TO USE THIS PRODUCT.
  122.  
  123. Copyright
  124. =========
  125.  
  126.    The `AmiQWK II' software and documentation are copyright (C)
  127. 1992,1993,1994 Jim Dawson. All rights reserved.
  128.  
  129.    `AmigaGuide', `AmigaGuide.info', `amigaguide.library' (C) Copyright
  130. 1992 Commodore-Amiga, Inc. All Rights Reserved. Reproduced and
  131. distributed under license from Commodore.
  132.  
  133.    `ReqTools' and `reqtools.library' are Copyright (C) Nico François.
  134.  
  135.    All product names used in this document are trademarks of their
  136. respective owners.
  137.  
  138. Distribution
  139. ============
  140.  
  141.    Regardless of the method of distribution, `AmiQWK II' is NOT and
  142. never has been public domain.
  143.  
  144.    `AmiQWK II' may be distributed freely, providing the following
  145. criteria are met:
  146.  
  147.    * Distribution is limited to the original shareware distribution
  148.      only. None of the files in the `AmiQWK II' distribution archive
  149.      may be modified or omitted.
  150.  
  151.    * No material gain may be realized from the distribution of `AmiQWK
  152.      II', other than a small amount to cover distribution materials.
  153.  
  154.    * `AmiQWK II' may be included in freely distributable software
  155.      libraries, including the Fred Fish collection and CD-ROM
  156.      distributions of the Aminet FTP site contents.
  157.  
  158.    * `AmiQWK II' may not be bundled with any hardware or software
  159.      product without prior written consent from the author.
  160.  
  161.    * Registration numbers for `AmiQWK', and the key file that `AmiQWK
  162.      II' generates from them (`AmiQWK.KEY') may not be distributed.
  163.  
  164. System Requirements
  165. *******************
  166.  
  167. Hardware Requirements
  168. =====================
  169.  
  170.    `AmiQWK' requires the following hardware:
  171.  
  172.    * Amiga computer.
  173.  
  174.    * 512KB RAM. (1MB or more recommended.)
  175.  
  176.    * Floppy drive (Second floppy drive or hard drive highly
  177.      recommended.)
  178.  
  179.    * Printer. (if you want to print messages.)
  180.  
  181. Software Requirements
  182. =====================
  183.  
  184.    `AmiQWK' requires the following software:
  185.  
  186.    * Workbench 2.04 (V37) or higher.
  187.  
  188.    * A text editor that can save ASCII text without any formatting info,
  189.      and can be configured so that it does not detach itself from it's
  190.      parent task. (ED and MEMACS that come with Workbench are fine.)
  191.  
  192.    * Any archivers you plan to use. (`ZIP', `LHA/LHArc', `ZOO', and
  193.      `ARC' are currently supported)
  194.  
  195.    * `reqtools.library'. (included with `AmiQWK II' distribution
  196.      archive.)
  197.  
  198.    * `amigaguide.library'. (included with `AmiQWK II' distribution
  199.      archive, only required for online help.)
  200.  
  201. Installation and Quick Setup
  202. ****************************
  203.  
  204.    To install `AmiQWK', just double-click on the 'Install_AQ2' icon.
  205. This will copy the `reqtools.library' and `amigaguide.library' to your
  206. `libs:' directory. If newer versions of either library are already
  207. present, the library will not be copied.
  208.  
  209.    Once the libraries have been installed, run `AmiQWK' by
  210. double-clicking on it's icon or by typing `AmiQWK' from the `CLI'.
  211.  
  212.    Once `AmiQWK' is running, you will need to configure it to work on
  213. your system. Click on the gadget labeled 'Config `AmiQWK'...' or type
  214. 'C' (1) to bring up the configuration editor window.
  215.  
  216.    The configuration editor window has 9 gadgets, the first 6 of which
  217. when clicked on will bring up a configuration sub-window. The remaining
  218. 3 gadgets are used to save the configuration to disk, use the
  219. configuration without saving, and to cancel changes you have made to
  220. the configuration. The following describes only the most basic
  221. configuration options needed to get `AmiQWK' running, See
  222. Configuration, for a more detailed description of all of the
  223. configuration options.
  224.  
  225. `Operation'
  226.      Change the 'Editor' string gadget to whatever editor you use.
  227.      About the only restrictions on the editor are that it must save
  228.      text in plain ASCII format (with no formatting codes) and that it
  229.      does not detach itself from the CLI process that spawned it. Here
  230.      are some examples:
  231.  
  232.     `CygnusEd'
  233.           `c:ed -sticky' (See CygnusEd Notes.)
  234.  
  235.     `TurboText'
  236.           `c:ttx WAIT'
  237.  
  238.     `Ed (AmigaDos)'
  239.           `c:ed'
  240.  
  241.     `MEmacs (AmigaDos)'
  242.           `sys:tools/memacs'
  243.  
  244.     `GoldEd'
  245.           `c:ed sticky'
  246.  
  247.     `Edge'
  248.           `EdgePrg:Edge SYNC' (See Edge Notes.)
  249.  
  250.      See Operation window, for more information.
  251.  
  252. `Replies'
  253.      The default configuration for replies should not need to be
  254.      changed for most applications. See Replies window, for more
  255.      information.
  256.  
  257. `Paths'
  258.      In the Paths window you tell `AmiQWK' where it should look for and
  259.      store certain files.
  260.  
  261.     `Packet Dir'
  262.           This is where `AmiQWK' should look for mail packets. This is
  263.           normally the same directory your term program uses for
  264.           downloads.
  265.  
  266.     `Reply Dir'
  267.           This is where `AmiQWK' stores replies. This is normally the
  268.           same directory your term program uses for uploads.
  269.  
  270.     `Work Dir'
  271.           This is where `AmiQWK' creates its work directory. If you
  272.           have enough memory, you might want to change this to `RAM:'
  273.           for best performance. If you leave it blank `AmiQWK' will
  274.           create the work directory in the `AmiQWK' program directory.
  275.  
  276.      See Paths window, for more information.
  277.  
  278. `Archivers'
  279.      You will probably not need to change anything in the Archivers
  280.      window.  See Archivers window, for more information.
  281.  
  282. `Graphics'
  283.      You will probably not need to make changes in the Graphics window
  284.      to get `AmiQWK' to work. See Graphics window, for more information.
  285.  
  286. `Register'
  287.      Enter your name in the gadget labeled 'Your Name'. If you have
  288.      registered, enter your registration key number in the
  289.      'Registration Key' gadget, otherwise leave it blank. See Register
  290.      window, for more information.
  291.  
  292.    Once you have your configuration set, click on the 'Save' gadget of
  293. the 'Config' window to save it to disk. If you think you messed up
  294. somewhere and want to start again from scratch, click on 'Cancel'. If
  295. you want to try out your configuration before you save it, click on
  296. 'Use'.
  297.  
  298.    ---------- Footnotes ----------
  299.  
  300.    (1)  Most actions in `AmiQWK' can be accomplished by using either
  301. the mouse or the keyboard. Whenever a keyboard shortcut exists it will
  302. usually have the shortcut key underlined.
  303.  
  304. Using AmiQWK
  305. ************
  306.  
  307. Starting AmiQWK
  308. ===============
  309.  
  310.    Before you use `AmiQWK', You will need to download a QWKMail packet
  311. from your favorite BBS. Consult the online documentation for the BBS
  312. QWK mailer (or, if all else fails, the system operator) for
  313. instructions on how to download a QWKMail packet. `AmiQWK' will run
  314. without any packets, but you won't be able to do much with it.
  315.  
  316.      *TIP:* Do *NOT* use Zmodem Resume mode when downloading QWKMail
  317.      packets.
  318.      
  319.      Since most BBSes use the same filename for packets every time, if you
  320.      already have a QWK packet in your downloads directory your term program will
  321.      think you are trying to resume an aborted transfer, and the new packet will
  322.      be appended to the old one instead of creating a new file.
  323.  
  324.    Once you have a QWKMail packet, start `AmiQWK' by double clicking
  325. the `AmiQWK' icon or typing '`AmiQWK'' from the CLI. `AmiQWK' will open
  326. a custom, public screen (named 'AMIQWK') with a window titled 'Select
  327. Packet'. (If you haven't registered yet, a window will appear reminding
  328. you to register before the 'Select Packet' window (See Select Packet
  329. window.) appears, as well as several other places in the program.) See
  330. Registration, for more details about registering `AmiQWK'.
  331.  
  332. Select Packet window
  333. ====================
  334.  
  335.    From the Select Packet window, you can open a QWKMail packet for
  336. reading, delete or rename packets, enter the configuration editor, and
  337. get information about the program. The Select Packet window has the
  338. following gadgets:
  339.  
  340. `Registered To'
  341.      Name of the registered user. See Registered To.
  342.  
  343. `Open Packet...'
  344.      Open a packet for reading. See Open Packet....
  345.  
  346. `Config AmiQWK...'
  347.      Open the configuration editor. See Main Configuration Window.
  348.  
  349. `About AmiQWK...'
  350.      Displays version, and copyright information, as well as how to get
  351.      technical support and where to send your registration fees. See
  352.      About AmiQWK....
  353.  
  354. `Rename Packet...'
  355.      Rename or move a packet. See Rename Packet....
  356.  
  357. `HELP!!!...'
  358.      Get online help. See HELP!!!....
  359.  
  360. `Delete Packet...'
  361.      Delete a packet. See Delete Packet....
  362.  
  363. `Quit and Exit...'
  364.      Exit program. See Quit and Exit....
  365.  
  366. Registered To
  367. =============
  368.  
  369.    This read only text gadget displays the name of the person who has
  370. registered this copy of `AmiQWK', or '** UNREGISTERED EVALUATION COPY
  371. **' if `AmiQWK' cannot process the registration key. See Registration,
  372. for more information on registering `AmiQWK'.
  373.  
  374. Open Packet...
  375. ==============
  376.  
  377.    When the 'Open Packet...' gadget is selected, `AmiQWK' opens a file
  378. requester for you to select the mail packet to be opened. See Opening a
  379. packet, for more information.
  380.  
  381. Config AmiQWK...
  382. ================
  383.  
  384.    Clicking on this gadget opens the configuration editor. See Main
  385. Configuration Window, for more information.
  386.  
  387. About AmiQWK...
  388. ===============
  389.  
  390.    This gadget opens a window containing version and copyright
  391. information, and where to send registrations, bug reports, suggestions,
  392. etc.
  393.  
  394. Rename Packet...
  395. ================
  396.  
  397.    This gadget opens a file requester to select a file to be renamed.
  398. Once a file is selected, another file requester is opened to select the
  399. new file name.
  400.  
  401.    A file can be moved by using the rename function. Just enter a
  402. different path in the 'Rename File As...' file requester. You can even
  403. 'Rename' a file to another volume.
  404.  
  405. HELP!!!...
  406. ==========
  407.  
  408.    This gadget brings up `AmigaGuide' help for the Packet Selection
  409. window. You can get help for most windows by pressing the 'HELP' key.
  410.  
  411. Delete Packet...
  412. ================
  413.  
  414.    This gadget opens a file requester to select a file to be deleted.
  415. Once a file is selected another requester will appear to ask for
  416. confirmation before deleting the file.
  417.  
  418. Quit and Exit...
  419. ================
  420.  
  421.    Click on this gadget to exit the program. Unless 'Ask Before Exit'
  422. in the Operations config window (See Operation window.) is turned off
  423. you will be asked for confirmation before `AmiQWK' closes.
  424.  
  425. Opening a packet
  426. ================
  427.  
  428.    When 'Open Packet...' is selected from the 'Select Packet' window, a
  429. file requester will appear to select the packet to open. Once a packet
  430. is selected, `AmiQWK' closes the 'Select Packet' window, extracts the
  431. mail packet into the work directory (automatically determining what
  432. method was used to compress the packet) as well as the reply packet, if
  433. it exists. The extraction procedure takes place in a CLI window that
  434. appears on the `AmiQWK' screen. (assuming you haven't changed the spawn
  435. window specifications in the Operations configuration window. (See
  436. Operation window.))
  437.  
  438.    Once the packet is extracted, `AmiQWK' will scan the packet,
  439. building lists of conferences and messages. This may take a while if
  440. you are reading a large packet. If index files are not present in the
  441. packet or if the number of messages in the messages.dat file does not
  442. match the number of message indexes, `AmiQWK' will attempt to generate
  443. the indexes itself. (note that the indexes are not saved back to the
  444. packet, as `AmiQWK' can generate the indexes very quickly.) Once the
  445. packet has been processed, the 'Select item to read' window will open.
  446. See Select item to read window.
  447.  
  448. Select item to read window
  449. ==========================
  450.  
  451.    This window gives important information about the packet and the BBS
  452. that it came from, and has several gadgets for selecting various parts
  453. of the mail packet for reading. (note that some of the gadgets may be
  454. disabled if the corresponding item is not available in the packet.)
  455. There is also a menu which can be used to generate requests to add,
  456. drop, or reset conferences (assuming that the QWK packer that generated
  457. the packet can process these requests, otherwise the menu items will be
  458. disabled.)
  459.  
  460.    The following information about the packet and the BBS it came from
  461. is displayed on the left part of the window.
  462.  
  463. `Packet:'
  464.      The filename of the packet (not including path).
  465.  
  466. `BBS:'
  467.      The name of the BBS that the packet came from.
  468.  
  469. `Location:'
  470.      The location of the BBS.
  471.  
  472. `Sysop:'
  473.      The name of the system operator of the BBS.
  474.  
  475. `Phone:'
  476.      Primary phone number of the BBS.
  477.  
  478. `Packet ID:'
  479.      Packet identifier for generating reply packets.
  480.  
  481. `Time:'
  482.      Time that the packet was created.
  483.  
  484. `Date:'
  485.      Date that the packet was created.
  486.  
  487. `User Name:'
  488.      Name of the person who downloaded the packet.
  489.  
  490.    And on the right are the following gadgets. Note that some of them
  491. may be disabled if they are not available.
  492.  
  493. `'Hello' File...'
  494.      Displays welcome text using the internal text viewer. (See Text
  495.      Viewer.) Usually is the login and welcome screen from the BBS, but
  496.      may contain other information.
  497.  
  498. `Bulletins...'
  499.      Display bulletin file(s) using the internal text viewer. (See Text
  500.      Viewer.) A file requester will be opened to select which file to
  501.      read. The bulletin files are named 'BLT-x.y' where 'x' is the
  502.      conference the bulletin came from and 'y' is the actual number of
  503.      the bulletin. (i.e. BLT-3.1 indicates that it is the first
  504.      bulletin in conference 3.) Bulletins are usually only included if
  505.      they have been updated since the last time you called the BBS.
  506.      Select 'Cancel' on the file requester to return to the 'Select
  507.      item to read' window.
  508.  
  509. `News...'
  510.      Display the News file using the internal text viewer. (See Text
  511.      Viewer.) This file can contain anything the sysop chooses. Usually
  512.      this file, like bulletins, is only included if it has been updated
  513.      since the last mail packet was downloaded.
  514.  
  515. `Read Mail...'
  516.      Read messages. (See Reading Messages.)
  517.  
  518. `New Files...'
  519.      Displays a list of files recently posted to the BBS using the
  520.      internal text viewer. (See Text Viewer.)
  521.  
  522. `'Goodbye' Text'
  523.      Displays logout text using the internal text viewer. (See Text
  524.      Viewer.) Usually this is the text that the BBS displays to users
  525.      logging off of the system, however it may contain other
  526.      information.
  527.  
  528. `Close Packet...'
  529.      Closes the packet currently being read and returns to the Select
  530.      Packet window. (See Select Packet window.) If there are any
  531.      replies, they will be packed into a reply packet for uploading.
  532.  
  533. `Exit AmiQWK...'
  534.      Exit program. Unless 'Ask Before Exit' in the Operations config
  535.      window is turned off (See Operation window.) you will be asked for
  536.      confirmation before `AmiQWK' closes. If there are any replies,
  537.      they will be packed into a reply packet for uploading.
  538.  
  539.    And finally, there is a menu named 'Conference'. It will contain the
  540. following menu items, however these items may be disabled if the QWK
  541. packer cannot handle these requests.
  542.  
  543. `Add Conference'
  544.      Add a conference to your list of active conferences. A window will
  545.      appear listing all conferences that don't have any messages in
  546.      them (if they have messages, you must already be subscribed to
  547.      that conference.) once a conference is selected, you will be asked
  548.      for confirmation before the add conference request is generated.
  549.  
  550. `Drop Conference'
  551.      Remove a conference from your list of active conferences. A window
  552.      will appear listing all conferences. Once a conference is
  553.      selected, you will be asked for confirmation before the drop
  554.      conference request is generated.
  555.  
  556. `Reset Pointer'
  557.      Reset last read pointer within a conference. A window will appear
  558.      listing all conferences. Once a conference is selected you will be
  559.      asked to enter a new last read message number. Once a last read
  560.      message number is selected, you will be asked for confirmation
  561.      before the reset request is generated.  See Advanced QWK features,
  562. for more details on Adding, Dropping, and Resetting conferences.
  563.  
  564. Text Viewer
  565. ===========
  566.  
  567.    `AmiQWK' has a built-in text viewer for reading text files included
  568. in the QWKMail packet, such as the Hello, Goodbye, News, Bulletins, and
  569. recent uploads files. ANSI display sequences are filtered out before
  570. the text is displayed. (Note that if the text uses ANSI cursor
  571. positioning codes, the text may be jumbled. However most ANSI text uses
  572. only color codes.)
  573.  
  574.    The following keys control movement in the text and message viewers:
  575.  
  576. Keypad 8, Up Arrow
  577.      Scroll up one line of text.
  578.  
  579. Keypad 2, Down Arrow
  580.      Scroll down one line of text.
  581.  
  582. Keypad 9
  583.      Scroll up one page of text.
  584.  
  585. Keypad 3 Space Bar
  586.      Scroll down one page of text.
  587.  
  588. Keypad 7
  589.      Move to start of text.
  590.  
  591. Keypad 1
  592.      Move to end of text.
  593.  
  594.    In addition to the above keys, you can move through the current text
  595. by using the scroll bar at the bottom of the screen. (unless the scroll
  596. bar is disabled in the Operations configuration window. (See Operation
  597. window.)
  598.  
  599.    The following keys (and their corresponding menu items in the
  600. 'Commands' menu) also perform functions:
  601.  
  602. Q
  603.      Quit reading text and return to the 'Select item to read' window.
  604.      See Select item to read window.
  605.  
  606. P
  607.      Print the current text. See Printing Text and Messages.
  608.  
  609. S
  610.      Save the current text. See Saving Text and Messages.
  611.  
  612. A
  613.      ANSI display of the current message. See ANSI Viewer.
  614.  
  615. ANSI Viewer
  616. ===========
  617.  
  618.    The ANSI viewer will display the current message or text on a virtual
  619. terminal, as if it were being viewed on a terminal screen while
  620. connected to a BBS. ANSI display sequences allow for changing the color
  621. of the text and background, cursor position, etc.
  622.  
  623.    The ANSI viewer will correctly display most IBM-PC ANSI sequences.
  624. ANSI is displayed on it's own custom 16 color screen, the palette is
  625. hard-coded to match the default IBM-PC display.
  626.  
  627.    The ANSI viewer uses the same font as is used for normal message
  628. text.
  629.  
  630.    When in the ANSI viewer the following functions are available:
  631.  
  632. P
  633.      Pause the display. Display will be suspended until another key is
  634.      pressed.
  635.  
  636. Q
  637.      Quit ANSI display and return to message or text reader.
  638.  
  639. A
  640.      Display ANSI text again.
  641.  
  642. 0-9
  643.      Change display speed. 0 is fastest (no delay), 9 is slowest (max.
  644.      delay).
  645.  
  646. Reading and Writing Messages
  647. ****************************
  648.  
  649. Reading Messages
  650. ================
  651.  
  652.    When 'Read Mail...' is selected from the 'Select item to read'
  653. window, (See Select item to read window.) the 'Select item to read'
  654. window is closed and you will enter the message reader.
  655.  
  656.    When you first enter the message reader, the 'Select Conference'
  657. window (See Conference Window.) will appear for you to select the
  658. conference you want to start reading from. It will default to the first
  659. conference with messages other than the 'Replies' conference. When you
  660. have selected a conference, `AmiQWK' will start displaying messages.
  661.  
  662.    The message reader is divided into two sections. The top section
  663. contains header information and several gadgets, and the bottom section
  664. contains the message text.
  665.  
  666.    The following header information is present in the header at the top
  667. of the screen:
  668.  
  669. From:
  670.      Sender of the message.
  671.  
  672. To:
  673.      Person the message is addressed to.
  674.  
  675. Subj:
  676.      Subject of the message.
  677.  
  678. Date:
  679.      Date the message was entered.
  680.  
  681. Time:
  682.      Time the message was entered.
  683.  
  684. Conference:
  685.      Name and number of the conference the message is in.
  686.  
  687. Message:
  688.      Message number, Number of this message out of the total available
  689.      in this conference, and the total number of messages in this
  690.      conference.  this packet.
  691.  
  692. Reply To:
  693.      Number of the message that this message is a reply to. (or blank
  694.      if it isn't a reply to another message.)
  695.  
  696. PRIVATE
  697.      If displayed, this message is tagged as being Private, usually
  698.      readable only by the sender, receiver, and system operator.
  699.  
  700. READ
  701.      If displayed, this message has already been read.
  702.  
  703. PERSONAL
  704.      If displayed, this message is addressed to you personally.
  705.  
  706.    In addition, there are six gadgets in the upper right of the screen.
  707. `Index'
  708.      Opens the Message Index window, to select a message to read. See
  709.      Message Index window.
  710.  
  711. `Conf.'
  712.      Opens the Conference window, to select which conference to read.
  713.      See Conference Window.
  714.  
  715. `Reply'
  716.      Reply to the current message. See Entering and re-editing new
  717.      messages.
  718.  
  719. `Help'
  720.      Call up the `AmigaGuide' help for the message viewer.
  721.  
  722. `<<'
  723.      Read the previous message.
  724.  
  725. `>>'
  726.      Read the next message.
  727.  
  728.    At the bottom of the screen is the message text. There is a scroll
  729. bar at the bottom (unless the scroll bar is disabled in the Operations
  730. configuration window.) which can be used to move through the message
  731. using the mouse. The following keys can also be used to move through
  732. the message.
  733.  
  734. Keypad 8, Up Arrow
  735.      Scroll up one line of message.
  736.  
  737. Keypad 2, Down Arrow
  738.      Scroll down one line of message.
  739.  
  740. Keypad 9
  741.      Scroll up one page of message.
  742.  
  743. Keypad 3, Space Bar
  744.      Scroll down one page of message.
  745.  
  746. Keypad 7
  747.      Move to start of message.
  748.  
  749. Keypad 1
  750.      Move to end of message.
  751.  
  752. Keypad 4, Left Arrow
  753.      Read the previous message in the current conference.
  754.  
  755. Keypad 6, Right Arrow, RETURN
  756.      Read the next message in the current conference.
  757.  
  758. SPACE BAR
  759.      Move forward 1 page. If the end of the message is passed the next
  760.      message is read.
  761.  
  762.    The following keys also perform functions:
  763.  
  764. A
  765.      ANSI display of the current message. See ANSI Viewer.
  766.  
  767. C
  768.      Open Conference window to select a new conference. See Conference
  769.      Window.
  770.  
  771. E
  772.      Re-edit Reply. (only works in 'Replies' conference.) See Entering
  773.      and re-editing new messages.
  774.  
  775. I
  776.      Open Message Index window to select which message to read in the
  777.      current conference. See Message Index window.
  778.  
  779. K
  780.      Kill (delete) the current message. (Only works in 'Replies'
  781.      conference.)
  782.  
  783. N
  784.      Enter a new message. See Entering and re-editing new messages.
  785.  
  786. P
  787.      Print the current message. See Printing Text and Messages.
  788.  
  789. Q, ESC
  790.      Exit message reader and return to the 'Select item to read'
  791.      window. See Select item to read window.
  792.  
  793. R
  794.      Reply to the current message. See Entering and re-editing new
  795.      messages.
  796.  
  797. S
  798.      Save the current message to disk. See Saving Text and Messages.
  799.  
  800. T
  801.      Add a new tagline to the tagline file. See New Tagline window.
  802.  
  803. Entering and re-editing new messages
  804. ====================================
  805.  
  806.    When you select 'Reply' or 'New message' when reading messages, the
  807. 'New Message' window is opened for information about the message. (such
  808. as who it is to, subject, etc.) and your editor is opened for you to
  809. enter your your message. (Note that you can alter the order the order
  810. in which the new message window is opened. You can configure `AmiQWK'
  811. to edit the message first then open the new message window, Open the
  812. new message window then edit the message, or open the new message
  813. window both before and after the message is edited (the default). See
  814. Replies window, for more information.)
  815.  
  816.    If you are replying to an existing message, the original message
  817. will be quoted in the new message text, with the quote prefix you
  818. selected in the Replies configuration window prefixed to each line. See
  819. Replies window.  When re-editing messages the text will be sent to the
  820. editor as-is.
  821.  
  822. `To'
  823.      This is the person the message is addressed to. If you are
  824.      replying to an existing message, this will default to the sender
  825.      of the message you are replying to. If it is a new message, this
  826.      field will be blank. This field is limited to 25 characters.
  827.  
  828. `From'
  829.      This is normally your name. You can change this field, however
  830.      most QWKMail systems will not allow messages to be posted unless
  831.      this field matches your name. This field is limited to 25
  832.      characters due to constraints of the QWKMail format.
  833.  
  834. `Subject'
  835.      This is the subject of the message. If you are replying to an
  836.      existing message this field will default to the subject of the
  837.      original message.  (with an optional 'RE:' prefix, provided that
  838.      'RE: prefix for reply subject' is turned on in the 'Replies'
  839.      configuration window and the subject doesn't already have a 'RE:'
  840.      prefix.) Otherwise this field is left blank so you can enter
  841.      whatever you want here. This field is limited to 25 characters due
  842.      to constraints of the QWKMail format.
  843.  
  844. `Conference'
  845.      This is the conference you want the message to be posted to. It
  846.      defaults to the conference you are currently reading messages in.
  847.      You can enter the conference number in the integer string gadget,
  848.      or you can click on the 'Conference' button and the Conference
  849.      window will appear for you to select a conference. (See Conference
  850.      Window.) The name of the conference will appear to the right of
  851.      the conference number gadget. `AmiQWK' will check the selected
  852.      conference number against a list of conferences to make sure you
  853.      have selected a valid conference.
  854.  
  855. `Public Status'
  856.      This is a cycle gadget that can be either set to 'Public' or
  857.      'Private'. A 'public' message will be visible to everyone, while a
  858.      'Private' message is usually only visible to the sender, the
  859.      person who it is addressed to, and the system operator. Note that
  860.      not all conferences support private messages.
  861.  
  862. `Return Receipt'
  863.      Tells the BBS to generate a return receipt message when this
  864.      message is received. This function is available only if it is
  865.      supported by the QWK mailer. Note that asking for a 'Return
  866.      Receipt' will prefix the Subject field with 'RRR'.
  867.  
  868. `Tagline'
  869.      This is a short one-line message that is appended to the end of
  870.      your message. You can select a tagline from the list gadget, or
  871.      type one into the string gadget below it. (If you enter a new
  872.      tagline, it will be appended to your tagline file for future use.)
  873.      Taglines are disabled when re-editing messages.
  874.  
  875. `Select Another Tagline'
  876.      If you don't like the tagline that `AmiQWK' has selected for you,
  877.      click on this gadget and a new one will be selected.
  878.  
  879. `OK'
  880.      Accept the current settings.
  881.  
  882. `Cancel'
  883.      Cancel the new message.
  884.  
  885. Writing messages and BBS Etiquette
  886. ==================================
  887.  
  888.    When writing a message, Keep in mind that others will have to read
  889. it.  There are certain things that you can do to
  890.  
  891.    * Avoid typing in all caps. Messages that are in all caps can be
  892.      difficult to read on some monitors.
  893.  
  894.    * When entering a reply, quote only the relevant information.
  895.  
  896.    * Try to keep your paragraphs short, and insert a blank line between
  897.      paragraphs.
  898.  
  899.    * Try to keep on the subject and don't post messages to areas where
  900.      they don't belong.
  901.  
  902.    Also remember that many BBSes are connected to BBS networks such as
  903. Fidonet and Usenet. Additional rules may apply to network message
  904. areas, such as high and low ASCII characters (ASCII 0-31 and 128-255)
  905. and ANSI escape sequences may not be permitted, etc. If you are in
  906. doubt as to what is and isn't permitted in a certain conference, ask
  907. the system operator or the network conference moderator for guidelines.
  908.  
  909. Conference Window
  910. =================
  911.  
  912.    The Conference window is used to select a conference. It consists of
  913. a list gadget listing all available conferences, and an OK and a cancel
  914. gadget.
  915.  
  916. `Conference List'
  917.      Lists all available conferences by name and number, with the total
  918.      number of messages in each conference. You can select a conference
  919.      by double-clicking on the desired line of the conference or by
  920.      selecting a conference and clicking on the 'OK' gadget.
  921.  
  922. `OK'
  923.      Accept the currently selected conference and close the Conference
  924.      window.
  925.  
  926. `Cancel'
  927.      Closes the Conference window and discards any conference selection.
  928.  
  929.    You can also control the Conference window with the keyboard.
  930.  
  931. C, Q, ESC
  932.      Closes the Conference window and discards any conference selection.
  933.  
  934. O, ENTER
  935.      Accept the currently selected conference and close the Conference
  936.      window.
  937.  
  938. Keypad 8, Up Arrow
  939.      Scroll up through the conference list.
  940.  
  941. Keypad 2, Down Arrow
  942.      Scroll down through the conference list.
  943.  
  944. Message Index window
  945. ====================
  946.  
  947.    The Message Index window is used to select a message from within a
  948. conference. It consists of a list gadget listing all available messages,
  949. and an OK and a cancel gadget. The operation of the Message Index
  950. window is nearly identical to the Conference window.
  951.  
  952. `message List'
  953.      Lists all available messages, by the To, From, Subject fields. The
  954.      following flags are present as well:
  955.  
  956.     `*'
  957.           The message is addressed to you personally.
  958.  
  959.     `R'
  960.           This message has been read.
  961.  
  962.     `P'
  963.           This message is marked as being Private.
  964.  
  965.      You can select a message by double-clicking on the desired line of
  966.      the message list, or by picking the desired conference with either
  967.      the mouse or keyboard and then clicking on the 'OK' gadget.
  968.  
  969. `OK'
  970.      Accept the currently selected message and close the Message Index
  971.      window.
  972.  
  973. `Cancel'
  974.      Closes the Message Index window and discards any message selection.
  975.  
  976.    You can also control the message window with the keyboard.
  977.  
  978. C, Q, ESC
  979.      Closes the Message Index window and discards any message selection.
  980.  
  981. O, ENTER
  982.      Accept the currently selected message and close the Message Index
  983.      window.
  984.  
  985. Keypad 8, Up Arrow
  986.      Scroll up through the message list.
  987.  
  988. Keypad 2, Down Arrow
  989.      Scroll down through the message list.
  990.  
  991. Saving Text and Messages
  992. ========================
  993.  
  994.    When you select 'Save', A file requester will open for you to select
  995. the file name to save the text or message to. If the file you selected
  996. already exists the new text or message will be appended to the end of
  997. the existing file. If you are saving a message the contents of the
  998. header will be saved as well.
  999.  
  1000.    The default path and/or directory for the saved text can be set in
  1001. the 'Paths' window of the config editor. See Paths window.
  1002.  
  1003. Printing Text and Messages
  1004. ==========================
  1005.  
  1006.    When you select 'Print', the current text or message will be sent to
  1007. the printer. If you are printing a message the contents of the header
  1008. will be printed as well.
  1009.  
  1010. New Tagline window
  1011. ==================
  1012.  
  1013.    The New Tagline window is used to enter a new tagline into the
  1014. taglines list file. It consists of three gadgets:
  1015.  
  1016. `Tagline'
  1017.      A string gadget to enter the new tagline into.
  1018.  
  1019. `OK'
  1020.      Close the New Tagline window and save the new tagline to the
  1021.      tagline list file.
  1022.  
  1023. `Cancel'
  1024.      Close the New Tagline window and discard the new tagline.
  1025.  
  1026.    One idea for those of you who like to steal taglines. Use a text
  1027. snapping program such as PowerSnap to cut taglines out of messages
  1028. using the mouse and then paste them into the New Tagline window.
  1029.  
  1030. Configuration
  1031. *************
  1032.  
  1033. Main Configuration Window
  1034. =========================
  1035.  
  1036.    The configuration editor consists of a main configuration window and
  1037. several sub-windows. The main Configuration window has the following
  1038. gadgets:
  1039.  
  1040. `Operation'
  1041.      Opens the Operation configuration window. The Operation window is
  1042.      used to configure the general operation of `AmiQWK'. See Operation
  1043.      window.
  1044.  
  1045. `Replies'
  1046.      Opens the Replies configuration window. The Relies window is used
  1047.      to configure how replies and new messages are processed. See
  1048.      Replies window.
  1049.  
  1050. `Paths'
  1051.      Opens the Paths configuration window. The Paths window is used to
  1052.      tell `AmiQWK' where it should look for and store files. See Paths
  1053.      window.
  1054.  
  1055. `Archivers'
  1056.      Opens the Archivers configuration window. The Archivers window is
  1057.      used to specify which compression programs are used and their
  1058.      command line options.  See Archivers window.
  1059.  
  1060. `Graphics'
  1061.      Opens the Graphics configuration window. The Graphics window is
  1062.      used to specify which screen mode the `AmiQWK' screen should open
  1063.      in, the font that should be used for text displays, the screen
  1064.      palette, etc. See Graphics window.
  1065.  
  1066. `Register'
  1067.      Opens the Registration configuration window. The Register window
  1068.      is used to enter your registration key when you register `AmiQWK'.
  1069.      See Register window.
  1070.  
  1071. `Save'
  1072.      Accepts the current configuration and saves it to disk and return
  1073.      to the 'Select Packet' window. See Select Packet window.
  1074.  
  1075. `Use'
  1076.      Accepts the current configuration and returns you to the 'Select
  1077.      Packet' window See Select Packet window. but does not save the new
  1078.      configuration to disk. If the new configuration is not saved to
  1079.      disk before exiting the program the new configuration will be lost.
  1080.  
  1081. `Cancel'
  1082.      Discard all changes to the configuration and return to the 'Select
  1083.      Packet' window. See Select Packet window.
  1084.  
  1085.    The configuration is saved in a file named 'Config.AQ' in the same
  1086. directory that `AmiQWK' is located in.
  1087.  
  1088. Operation window
  1089. ================
  1090.  
  1091.    The Operation window is used to configure the general operation of
  1092. `AmiQWK'.
  1093.  
  1094. `Scroll bar in text window'
  1095.      If this checkbox gadget is selected, a scroll bar will appear at
  1096.      the bottom of the text and message windows. This scroll bar can be
  1097.      used to move around the displayed text using the mouse.
  1098.  
  1099. `Tab Size'
  1100.      This slider gadget specifies the number of spaces between tab
  1101.      stops.
  1102.  
  1103. `Ask before Exit'
  1104.      If this checkbox is selected, `AmiQWK' will ask for confirmation
  1105.      before exiting. Otherwise it will exit without asking first.
  1106.  
  1107. `After Read'
  1108.      This cycle gadget is used to tell `AmiQWK' what to do with a
  1109.      packet after you read it. It can be set to:
  1110.  
  1111.     `No Action'
  1112.           Nothing is done to the packet after you read it.
  1113.  
  1114.     `Rename Packet'
  1115.           You will be presented with a file requester to change the
  1116.           name of the packet after you read it.
  1117.  
  1118.     `Delete Packet.'
  1119.           You will be asked if you want to delete the packet after you
  1120.           read it.
  1121.  
  1122.     `Ask'
  1123.           You will be presented with a requester asking if you want to
  1124.           Rename, Delete, or take no action at all on the packet after
  1125.           you have read it.
  1126.  
  1127. `Packet Search Pattern Match'
  1128.      This is the pattern that `AmiQWK' should use when looking for mail
  1129.      packets.  It should normally be something like '#?.Q#?' as packet
  1130.      names normally end with '.QWK' and some term programs may change
  1131.      the extension if a duplicate file is downloaded.
  1132.  
  1133. `Editor'
  1134.      This is the command line used to start your editor for editing
  1135.      messages. Be sure to specify any command line switches you need
  1136.      here as well. The file name will be appended to the end of this
  1137.      string.
  1138.  
  1139.      Keep in mind that your text editor must NOT detach itself from the
  1140.      process that started it.
  1141.  
  1142.      Here are some example editor strings for various editors.
  1143.  
  1144.     `CygnusEd'
  1145.           `c:ed -sticky' (See CygnusEd Notes.)
  1146.  
  1147.     `TurboText'
  1148.           `c:ttx WAIT'
  1149.  
  1150.     `Ed'
  1151.           `c:ed'
  1152.  
  1153.     `MEmacs'
  1154.           `sys:tools/memacs'
  1155.  
  1156.     `GoldEd'
  1157.           `c:ed sticky'
  1158.  
  1159.     `Edge'
  1160.           `EdgePrg:Edge SYNC' (See Edge Notes.)
  1161.  
  1162.      If you are using `CygnusEd', See CygnusEd Notes.  If you are using
  1163.      `Edge', See Edge Notes.
  1164.  
  1165. `Workbench to front on edit'
  1166.      If this checkbox is selected, `AmiQWK' will pull the workbench
  1167.      screen to front when the editor is started. This is useful if you
  1168.      are using an editor that opens on the workbench screen but does
  1169.      not pull it to the front for you, such as the 'ed' program that
  1170.      comes with Workbench.
  1171.  
  1172. `Spawn Window'
  1173.      This string gadget is used to set the console specifications for
  1174.      the spawn window for extracting packets and packing replies. See
  1175.      your AmigaDos manual for more information on console
  1176.      specifications. If you want the spawn window to open on the
  1177.      `AmiQWK' screen, make sure that 'SCREENAMIQWK' appears somewhere
  1178.      on this line.
  1179.  
  1180. `Requesters'
  1181.      Allows you to choose between ASL and `ReqTools' file, font, and
  1182.      screenmode requesters. (note that `AmiQWK' will use the `ReqTools'
  1183.      screenmode requester if you are using version 37 of ASL.library,
  1184.      because ASL.library v37 does not have a screenmode selector.)
  1185.  
  1186. `Use'
  1187.      Use the current settings and return to the main configuration
  1188.      window. See Main Configuration Window.
  1189.  
  1190. `Cancel'
  1191.      Discard changes and return to the main configuration window. See
  1192.      Main Configuration Window.
  1193.  
  1194. CygnusEd Notes
  1195. ==============
  1196.  
  1197.    If you are using `CygnusEd' version 2.12 or earlier, you may have
  1198. trouble getting `CygnusEd' to open without detaching itself from it's
  1199. parent process due to a bug in the `ED' activator program. If you are
  1200. using `CygnusEd' 2.12, there are three options open to you.
  1201.  
  1202.    * You can upgrade to a newer version of `CygnusEd'.
  1203.  
  1204.    * You can get a third party replacement for the '`ED'' activator
  1205.      program.  There are at least two in the public domain. At least
  1206.      one of them will be available from the `AmiQWK' support BBS at all
  1207.      times. See Technical Support.
  1208.  
  1209.    * You can use the included `CygnusEd' starter script. (filename
  1210.      `StartCed', set the 'Editor' gadget in the 'Operation' window of
  1211.      the config editor to '`StartCed'' if you use this script. You may
  1212.      also need to specify the full path to the `StartCed' script.)
  1213.  
  1214.    For best results, you will probably want to 'hot-start' `CygnusEd'
  1215. from the `s:user-startup' file. See your `CygnusEd' program for details
  1216. on 'hot-starting'.
  1217.  
  1218. Edge Notes
  1219. ==========
  1220.  
  1221.    The original version of `Edge' did not have a command line switch to
  1222. remain attached to the process that started it, and the most recent
  1223. version (1.721) has added the 'SYNC' switch as an afterthought. The
  1224. 'SYNC' switch will lock the shell used to start `Edge' until the
  1225. program is shut down.  (i.e. when 'Quit Program' is selected from the
  1226. 'Project' menu.) This switch will only work if `Edge' is not currently
  1227. running, and as of the most recent version (1.721) it does not work in
  1228. the 68020 version. If you have a 68020 or better and want to use Edge
  1229. with `AmiQWK', extract the file `Edge_C000.lha' from your `Edge'
  1230. distribution disk to your `EDGEPRG:' directory.
  1231.  
  1232.    As I stated before, in order to use `Edge' with `AmiQWK', you must
  1233. _NOT_ have `Edge' running when `AmiQWK' is running, except when you are
  1234. editing messages. When you are done editing a message, be sure to
  1235. select 'Quit Program' from the 'Project' menu to shut down `Edge'.
  1236.  
  1237.    Hopefully, in the near future INOVATroncs will add a command line
  1238. switch to keep `Edge' from detaching itself from the CLI that started
  1239. it, even if `Edge' is already running. Until that time, if anyone comes
  1240. up with a better way to interface `Edge' to AmiQWK, please let me know.
  1241.  
  1242. Replies window
  1243. ==============
  1244.  
  1245. `Edit Header'
  1246.      This cycle gadget has three settings. It controls when the message
  1247.      editor and the 'New Message' window are opened.
  1248.  
  1249.     `Before Edit'
  1250.           Edit message header in the 'New Message' window before
  1251.           editing the message text.
  1252.  
  1253.     `After Edit'
  1254.           Edit message header in the 'New Message' window after editing
  1255.           the message text.
  1256.  
  1257.     `Before and After Edit'
  1258.           Edit message header in the 'New Message' window both before
  1259.           and after editing the message text.
  1260.  
  1261. `Quote Prefix'
  1262.      This string is prefixed before each line of quoted text when
  1263.      replying to a message.
  1264.  
  1265. `Header Info in replies'
  1266.      If this checkbox is selected, the information in the message
  1267.      header will be included in the message text of a reply. Has no
  1268.      effect on new messages.  (i.e. not a reply to an existing message.)
  1269.  
  1270. `RE: prefix for reply subject'
  1271.      If this checkbox is selected, the subject field of the new message
  1272.      will be prefixed with 'RE:' unless it already has a 'RE:' prefix.
  1273.  
  1274. `Trunc/Wrap reply text'
  1275.      Specifies if quoted text in a reply is to be truncated or word
  1276.      wrapped.
  1277.  
  1278. `Col.'
  1279.      Specifies column that quoted text in a reply is to be truncated or
  1280.      word wrapped at.
  1281.  
  1282. `Use'
  1283.      Use the current settings and return to the main configuration
  1284.      window. See Main Configuration Window.
  1285.  
  1286. `Cancel'
  1287.      Discard changes and return to the main configuration window. See
  1288.      Main Configuration Window.
  1289.  
  1290. Paths window
  1291. ============
  1292.  
  1293.    The paths window is used to tell `AmiQWK' where it should look for
  1294. and store files. To the right of each path string gadget is a
  1295. 'pickfile' button, which will open a file requester to select the
  1296. desired path. You can either type the path into the string gadget or
  1297. select the path from the file requester.
  1298.  
  1299. `Packet Directory'
  1300.      Tells `AmiQWK' where it should look for mail packets. This should
  1301.      be set to the downloads directory your terminal program uses.
  1302.  
  1303. `Reply Directory'
  1304.      Tells `AmiQWK' where it should store reply packets. This should be
  1305.      set to the uploads directory your terminal program uses.
  1306.  
  1307. `Work Directory'
  1308.      Tells `AmiQWK' where it should create it's work directory. If you
  1309.      have enough memory, this should be set to `RAM:' for best
  1310.      performance. If this field is left blank, `AmiQWK' will create
  1311.      it's work directory in the directory in the same directory as the
  1312.      `AmiQWK' executable file.
  1313.  
  1314. `Saved Text'
  1315.      Default path and/or filename for saved text. You can enter a
  1316.      complete path with filename, just a filename (the files will be
  1317.      saved to the `AmiQWK' directory unless you specify a path when you
  1318.      save messages or text files) or just a path (you will need to make
  1319.      sure that the path name ends with a ':' or a '/', otherwise
  1320.      `AmiQWK' will think that the last part of the path is actually a
  1321.      file name.)
  1322.  
  1323. `Use'
  1324.      Use the current settings and return to the main configuration
  1325.      window. See Main Configuration Window.
  1326.  
  1327. `Cancel'
  1328.      Discard changes and return to the main configuration window. See
  1329.      Main Configuration Window.
  1330.  
  1331. Archivers window
  1332. ================
  1333.  
  1334.    The Archivers window is used to specify the command line strings for
  1335. the file compression/extraction programs. Currently `AmiQWK' supports
  1336. `LHA/LHArc', `ZIP', `ZOO', and `ARC' compression. The filename and
  1337. destination directory will be appended to the command line strings.
  1338.  
  1339. `Use'
  1340.      Use the current settings and return to the main configuration
  1341.      window. See Main Configuration Window.
  1342.  
  1343. `Cancel'
  1344.      Discard changes and return to the main configuration window. See
  1345.      Main Configuration Window.
  1346.  
  1347. Graphics window
  1348. ===============
  1349.  
  1350.    The Graphics window is used to specify the general appearance of
  1351. `AmiQWK'.
  1352.  
  1353. `Screen Mode'
  1354.      The name of the screen mode that `AmiQWK' opens on. (Read only,
  1355.      use the 'Select Screen Mode' gadget to select a screen mode.)
  1356.  
  1357. `Width'
  1358.      The width of the `AmiQWK' screen in pixels. (Read only)
  1359.  
  1360. `Height'
  1361.      The height of the `AmiQWK' screen in pixels. (Read only)
  1362.  
  1363. `Select Screen Mode'
  1364.      Select a screen mode for `AmiQWK' using the ASL or `ReqTools'
  1365.      screenmode requester. (If you are using version 37 of ASL.library,
  1366.      the `ReqTools' screenmode requester will be used.) You can also
  1367.      specify the number of colors the `AmiQWK' screen uses. (I
  1368.      recommend using 4 colors. At this time `AmiQWK' does not use more
  1369.      than four colors except for the ANSI display screen, which is hard
  1370.      coded to use a 16 color screen.)
  1371.  
  1372. `Shanghai'
  1373.      If this checkmark is selected, the `AmiQWK' screen will be opened
  1374.      in 'Shanghai' mode. If this option is set, older applications that
  1375.      would normally open on the Workbench screen instead open on the
  1376.      default public screen, which may or may not be the Workbench
  1377.      screen.
  1378.  
  1379. `PopPubScreen'
  1380.      If this checkmark is selected, the `AmiQWK' screen will be opened
  1381.      in 'PopPubScreen' mode. This will cause the AmiQWK screen to 'pop'
  1382.      to the front whenever a window is opened on the AmiQWK screen.
  1383.  
  1384. `Edit Palette'
  1385.      Change the color palette `AmiQWK' uses using the `ReqTools'
  1386.      palette requester.
  1387.  
  1388. `Select Font'
  1389.      Select the font `AmiQWK' uses for message text and the ANSI
  1390.      display, using the ASL or `ReqTools' font requester. The selected
  1391.      font and size will appear to the right of the 'Select Font'
  1392.      gadget. I recommend using an IBM-PC style font as many packets
  1393.      will contain characters that only appear properly when viewed with
  1394.      an IBM-PC style font.
  1395.  
  1396. `Use'
  1397.      Use the current settings and return to the main configuration
  1398.      window. See Main Configuration Window.
  1399.  
  1400. `Cancel'
  1401.      Discard changes and return to the main configuration window. See
  1402.      Main Configuration Window.
  1403.  
  1404. Register window
  1405. ===============
  1406.  
  1407.    The Register window is used generate a registration keyfile. When you
  1408. register you will be given a 16 digit registration number which should
  1409. be entered into this window.
  1410.  
  1411. `Your Name'
  1412.      Enter your name into this gadget. It must be entered exactly as it
  1413.      was specified on your registration form as the registration key is
  1414.      matched against this field.
  1415.  
  1416. `Registration Key'
  1417.      Enter your 16 digit registration number in this gadget.
  1418.  
  1419. `Status'
  1420.      Registration status. Will either be a registration serial number
  1421.      or '** UNREGISTERED EVALUATION COPY **' if a valid registration
  1422.      key is not present.
  1423.  
  1424. `Use'
  1425.      Save your registration key to disk and return to the main
  1426.      configuration window. See Main Configuration Window.
  1427.  
  1428. `Cancel'
  1429.      Discard changes and return to the main configuration window. See
  1430.      Main Configuration Window.
  1431.  
  1432. Advanced QWK features
  1433. *********************
  1434.  
  1435.    Some BBSes allow for adding, dropping, and resetting of conferences,
  1436. downloading files attached to messages, and other functions by sending
  1437. messages to the BBS via a QWKmail packet. If the BBS supports these
  1438. features a file named DOOR.ID will be included in the QWKMail packet
  1439. that will tell `AmiQWK' what functions are available and how to process
  1440. a request.
  1441.  
  1442.    For example, if you had a packet from a Wildcat! BBS and had `AmiQWK'
  1443. generate a request to add conference #25, `AmiQWK' would generate a
  1444. message with the following header information:
  1445.  
  1446. FROM: <your name>
  1447.  
  1448. TO: TOMCAT
  1449.  
  1450. SUBJ: ADD
  1451.  
  1452. CONFERENCE 25
  1453.  
  1454.    If you decide to abort the request, just enter the 'Replies'
  1455. conference and 'Kill' the request message. (See Reading Messages.)
  1456.  
  1457. The Future of AmiQWK
  1458. ********************
  1459.  
  1460.    `AmiQWK III' will be a complete rewrite of the existing code. Some of
  1461. the features I plan on adding are:
  1462.  
  1463.    * A whole new multi-window, multi-packet environment.
  1464.         - Any number of packets can be opened at a time, limited only by
  1465.           available memory.
  1466.  
  1467.    * Sorting
  1468.         - Conferences by Name or Number.
  1469.  
  1470.         - Messages by To, From, Subject, Message Number, etc.
  1471.  
  1472.    * String search for message by to:, from:, subject:, message text.
  1473.  
  1474.    * Improvement of quote system.
  1475.         - Quote prefix may contain initials, first name of the person
  1476.           who's text is quoted, etc.
  1477.  
  1478.    * Tagline manager
  1479.         - Edit, Delete, Sort, Find tagline functions.
  1480.  
  1481.         - multiple tagline files can be maintained. (such as a file
  1482.           containing only Star Trek quotes, etc.)
  1483.  
  1484.         - A true 'Steal Tagline' function.
  1485.  
  1486.    * Database of BBS and packet information
  1487.         - Keep a record of which packets have been read, etc.
  1488.  
  1489.         - Keep record of conferences and other information about the
  1490.           packets a BBS generates, so that a reply packet can be
  1491.           generated even if no packet exists for the BBS.
  1492.  
  1493.         - Keep a address book of people you regularly send messages to,
  1494.           including network addresses, phone and fax numbers, etc.
  1495.  
  1496.         - Keep a 'Twit' list. Ignore messages with certain topics or
  1497.           from/to persons listed.
  1498.  
  1499.    * 'Blue Wave', 'SOUP', and 'QWK-II' (if the specifications are ever
  1500.      released) packet support.
  1501.  
  1502.    * Support for MIME multimedia mail extensions.
  1503.  
  1504.    * Possible UUCP, TCP/IP, Fidonet, and FAX interfaces.
  1505.  
  1506.    * UUEncode/UUDecode support.
  1507.  
  1508.    * PGP (Pretty Good Privacy) support.
  1509.  
  1510.    * 'Text Variables' for inserting information into text, such as who
  1511.      the message is to/from, etc.
  1512.  
  1513.    * 'Headers' (text appended before message, e.g. 'In message to xxx,
  1514.      yyy said...'), and 'Footers' (text appended to end of message,
  1515.      e.g. USENET style signatures.)
  1516.  
  1517.    * Locale support for multilingual operation.
  1518.  
  1519.    * ARexx Interface
  1520.  
  1521.    If there is a feature you would like to see in a future version, let
  1522. me know about it, even if I listed it already. If I get a lot of
  1523. requests I may move it to a higher position on the list.
  1524.  
  1525.    Remember, The future of `AmiQWK' depends on YOU! Send in your
  1526. registration as soon as possible.
  1527.  
  1528. Technical Support
  1529. *****************
  1530.  
  1531.    Technical support for `AmiQWK' is available through the following:
  1532.  
  1533. Electronic Mail
  1534.     INTERNET
  1535.              * jim_dawson@hguild.com
  1536.  
  1537.              * jim.dawson@poohs.com
  1538.  
  1539.     FIDONET
  1540.              * BBS-42 1:3612/42.0
  1541.  
  1542.     BBS
  1543.              * Poohs Corner BBS
  1544.                (618) 985-4747
  1545.  
  1546.              * BBS-42
  1547.                (904) 438-4803
  1548.  
  1549.     FAX
  1550.              * (618) 993-9153
  1551.  
  1552.           Technical support by fax available in North America only. If
  1553.           you want to fax me from outside of North America, please
  1554.           include a postal address or a Fidonet/Internet address.
  1555.  
  1556. Postal Mail
  1557.      Jim Dawson
  1558.      509 S. Madison St.
  1559.      Marion, IL. 62959
  1560.      USA
  1561.  
  1562.    When asking for help, please give as complete description of your
  1563. problem as possible, as well as a complete description of your system
  1564. and any software that might also be running at the same time as
  1565. `AmiQWK'. The more information I have the faster I can suggest a
  1566. solution to your problem.
  1567.  
  1568.    I will personally post new versions of `AmiQWK' to Aminet FTP sites
  1569. (look for them in the /pub/aminet/comm/mail directory), to BBS-42
  1570. (904-438-4803) and Pooh's Corner BBS (618-985-4747). Fidonet users can
  1571. FREQ `AmiQWK' from BBS-42 at node 1:3612/42.0 by requesting magic name
  1572. 'AMIQWK'. New versions will be submitted to Fred Fish for inclusion in
  1573. his library of freely distributable software.
  1574.  
  1575. Acknowledgments
  1576. ***************
  1577.  
  1578.    Special thanks go to:
  1579.  
  1580. `Jefferey Foy'
  1581.      For information on the QWKMail format and MSBIN-IEEE conversion
  1582.      routines.
  1583.  
  1584. `Greg Hewgill'
  1585.      For specifications of the DOOR.ID file.
  1586.  
  1587. `Patrick Y. Lee'
  1588.      For his excellent document on the QWKMail format.
  1589.  
  1590. `Marcus Trisdale'
  1591.      For his ANSI display code.
  1592.  
  1593. `Jan van den Baard'
  1594.      For his GadToolsBox GUI builder program.
  1595.  
  1596. `Nico François'
  1597.      For `reqtools.library'
  1598.  
  1599. `Robert J Chassell and Richard M. Stallman'
  1600.      for the Texinfo documentation format.
  1601.  
  1602. `Reinhard Spisser and Sebastiano Vigna'
  1603.      for `MakeGuide'.
  1604.  
  1605. `Chris Hurley, Guy Bartoli, Dave Birdsong, Dennis Jann, Mike Soucy,'
  1606. `Kipling Cooper, Steve Stewart, and Matt Weatherford'
  1607.      for Beta Testing `AmiQWK'
  1608.  
  1609. `Peter Lowish'
  1610.      for handling AmiQWK registrations in New Zealand and Australia.
  1611.  
  1612. `Christian Tauscher'
  1613.      for handling AmiQWK registrations in Europe.
  1614.  
  1615.    And of course, everyone who has sent in registrations.
  1616.  
  1617.